Moves a control within its window.

void MoveControl (
    ControlRef theControl, 
    SInt16 h, 
    SInt16 v
);

theControl

A handle to the control you wish to move.

h

The horizontal coordinate (local to the control’s window) of the new location of the upper-left corner of the control’s rectangle.

v

The vertical coordinate (local to the control’s window) of the new location of the upper-left corner of the control’s rectangle.

DISCUSSION

The MoveControl function moves the control to the new location specified by the h and v parameters, using them to change the rectangle specified in the contrlRect field of the control structure. When the control is visible, MoveControl first hides it and then redraws it at its new location.

For example, if the user resizes a document window that contains a scroll bar, your application can use MoveControl to move the scroll bar to its new location.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)